home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 002 / paste.arc / PASTE.DOC next >
Encoding:
Text File  |  1986-12-14  |  2.9 KB  |  79 lines
  1.  
  2. NAME
  3.         paste - horizontally concatenate two files.
  4.  
  5. SYNOPSIS
  6.         paste [-paste] [-b <string>] [-<n>] [file1] [file2]
  7.  
  8. DESCRIPTION
  9.         Paste will append to the lines of <file1> the corresponding lines
  10.         of <file2>, with an optional string between them.  Paste writes
  11.         to standard output.
  12.  
  13.         The following flags are recognized by paste.
  14.  
  15.         -p      <file1> does not exist (<string> is prepended to each line.)
  16.  
  17.         -a      <file2> does not exist (<string> is appended to each line.)
  18.  
  19.         -s      Do not print <string> with lines from only one file.
  20.  
  21.         -t      An option to resolve the ambiguous command "paste <file>".
  22.                 The -t flag forces <file> to trail standard input. I.e.,
  23.  
  24.                 "paste <file>"
  25.                         is equivalent to "paste <file> <stdin>"
  26.  
  27.                 "paste -t <file>"
  28.                         is equivalent to "paste <stdin> <file>".
  29.  
  30.         -e      Do not print <string> if both input lines are empty
  31.                 (i.e., that contain no characters but '\n'.)
  32.  
  33.         -b      Indicates that a string of characters follow.  The string
  34.                 is inserted between each line of <file1> and <file2>.  The
  35.                 string may contain all the standard escape codes with the
  36.                 exception of '\0'.  The escape sequence '\s' is also known
  37.                 to represent a blank.  Blanks may also be imbedded in a
  38.                 string by enclosing the string in quotes.
  39.  
  40.         -<n>    Print n lines of <file1> before appending lines of <file2>.
  41.                 If n is negative (e.g., "paste --3") then n lines of
  42.                 <file2> will be printed first.
  43.  
  44.  
  45. BUGS
  46.         On some systems, you'll have to use an escape sequence to
  47.         represent capital letters in "string".  Also, a quoted string
  48.         with multiple blanks may have them reduced to single blanks
  49.         on systems that do not recognize quote marks as special.  Use
  50.         the escape sequences '\s' or '\ '.
  51.  
  52.         As of this writing, the standard escape sequences are:
  53.                 \b      backspace
  54.                 \f      formfeed
  55.                 \n      newline
  56.                 \r      carriage return
  57.                 \t      tab
  58.                 \0      Null character (not allowed in string argument)
  59.                 \\      literal backslash
  60.                 \"      literal quote mark
  61.                 \'      literal apostrophe
  62.                 \ddd    bit pattern, consisting of 1 to 3 octal digits
  63.  
  64.         Escape sequences special to paste:
  65.                 \s      space
  66.  
  67.         A backslash followed by any other character merely represents
  68.         that character.
  69.  
  70. AUTHOR
  71.         John M. Gamble, January, 1984
  72.     2550 Yeager Road, #15-2
  73.     West Lafayette, IN  47906
  74.  
  75.         Updated for UNIX April, 1986
  76.  
  77.  
  78. Tested 12/3/86 by Ray Duncan with Microsoft C and MS-DOS 3.1
  79.